IBM(TM) OS/2(R) WARP(R) DEVELOPER KIT,
JAVA(TM) 2 TECHNOLOGY EDITION, 1.3
INSTALLATION AND CONFIGURATION GUIDE


(c) Copyright IBM Corporation 1999, 2001. All rights reserved.

(c) Copyright Sun Microsystems, Inc. 1997, 2001. 901 San Antonio Rd., Palo Alto, CA 94303 USA. All rights reserved.

Note: The complete copyright citation is included in the Notices section of this document.


This guide provides information about the IBM OS/2 Warp Developer Kit, Java(TM) 2 Technology Edition, Version 1.3 (Developer Kit). This guide gives information on preparing to install the Developer Kit components, installing the Developer Kit components, and items to note after you install.

The Developer Kit is supported on the following OS/2 products:

Note:  For information on FixPak requirements or the IBM FixPak Web site, see the FixPaks section.

To obtain the IBM build and version number for the Developer Kit, type the following at a command line:

     java -version

Contents

  • 1.0 BEFORE YOU INSTALL
  • 1.1 Installation Requirements
  • 1.2 Extracting the Files for Installation
  • 1.3 File System Partition Considerations
  • 1.4 FixPaks
  • 1.5 Installing the Developer Kit as the Default JVM
  • 1.6 Netscape Communicator Information
  • 1.7 Joining Split Files


  • 2.0 INSTALLING THE DEVELOPER KIT
  • 2.1 GUI Installation Method
  • 2.2 Unattended (CID) Installation Method
  • 2.3 NVDM/2 Installation Considerations
  • 2.4 Installing the Developer Kit on WorkSpace On-Demand 2.0
  • 2.5 Installing the Developer Kit on WorkSpace On-Demand 3.0 Client
  • 2.6 Remote IPL Installation Method

  • 3.0 AFTER YOU INSTALL
  • 3.1 Additional Sources of Information
  • 3.2 Installing Additional Components
  • 3.3 AWT TextField and TextArea Considerations
  • 3.4 Modifying Font Properties Files is Not Supported
  • 3.5 Time Problems in Java Applets
  • 3.6 Using the OS/2 High Memory Support to Increase the Java Heap Size
  • 3.7 Enhanced BigDecimal Class
  • 3.8 The Java Plug-ins
  • 3.9 Turning Off the JIT Compiler
  • 3.10 File Name Changes
  • 3.11 Configuring the Applet Viewer
  • 3.12 Specifying Java Options and System Properties
  • 3.13 RMI Over IIOP
  • 3.14 Java Authentication and Authorization Service (JAAS)
  • 3.15 JNI Programming Information


  • 4.0 ADDITIONAL FONT PACKAGES
  • 4.1 Installing Additional Font Packages

  • 5.0 DOUBLE-BYTE CHARACTER SET (DBCS) INFORMATION
  • 5.1 Installation Panel Text Missing or Too Long in DBCS Countries
  • 5.2 TrueType Fonts Must Be Installed on Chinese Systems
  • 5.3 Program Temporary Fixes and FixPaks for DBCS Systems
  • 5.4 Controlling Arabic Number Character Display
  • 5.5 Japanese Environment Settings on OS/2 Warp 4 Japanese Version
  • 5.6 Required Fonts on OS/2 Warp Japanese Version
  • 5.7 Improving Font Quality on OS/2 Warp Server for e-business
  • 5.8 Installing the Developer Kit on a DBCS OS/2 WorkSpace On-Demand 3.0 Sandbox Client


  • 6.0 UNINSTALLING THE DEVELOPER KIT
  • 6.1 Desktop Method
  • 6.2 OS/2 Command Prompt Method
  • 6.3 Uninstalling the Developer Kit from WorkSpace On-Demand 2.0
  • 6.4 Performing an Unattended Uninstallation
  • 6.5 Removing the Developer Kit as the Default JVM


  • 7.0 KNOWN LIMITATIONS


  • 8.0 NOTICES


  • 9.0 TRADEMARKS

  • 1.0 BEFORE YOU INSTALL

    The Developer Kit consists of two packages: a Runtime Environment and a Toolkit. The Runtime Environment includes such components as JAAS, RMI-IIOP Runtime, and the just-in-time (JIT) compiler. The Toolkit contains such components as a toolkit, the Interactive Code Analysis Tool (ICAT) Debugger, and Samples.

    Note:  You cannot install the Toolkit unless you are also installing the Runtime.

    If you downloaded split files, refer to the Joining Split Files section for information on joining the split files into one installable file.

    Before installing the Developer Kit, make a copy of your current CONFIG.SYS file. This ensures that you can return to your original environment if problems occur during installation.

    References in this guide are as follows:


    1.1 Installation Requirements

    Diskspace Requirements:

    The following is a list of the Developer Kit's components and file sizes after installation. You should ensure that sufficient disk space is available before installing.

    Component Size
    Runtime 22.0 MB
    Toolkit 25.0 MB
    Samples  5.0 MB
    ICAT Debugger for OS/2 Java 13.0 MB
    Total Installed Size 65.0 MB
    List of the Developer Kit's components and file sizes after installation.

    Hardware Requirements:

    Software Requirements:


    1.2 Extracting the Files for Installation

    To extract a self-extracting ZIP file, complete the following steps:

    1. Create a subdirectory (if you haven't already done so) to store the self-extracting ZIP file on your hard drive.
    2. Execute the file by typing the file name at a command prompt from within the directory that you downloaded the file.

    If you downloaded split files and need to join them into one installable file, refer to the Joining Split Files section. Information on installing the Developer Kit is located in the Installing the Developer Kit section.


    1.3 File System Partition Considerations

    The following considerations apply when installing the Developer Kit:

    If you have only one hard disk with a single FAT partition, you have these options:

    Note:  In this document, the term "partition" refers to any physical or logical drive.


    1.4 FixPaks

    The following considerations apply:

    System FixPak Level Required for OS/2 Warp 4
    SBCS DBCS
    FixPak 5 FixPak FX00505
    FixPak level considerations.

    To use the euro in Java applications and applets
    OS/2 Warp 4 FixPak 6 or later
    FixPak levels for using the euro.

    Note: The display and code conversion of the euro are supported on the code pages containing the euro.

    If you want to input the euro, the single-byte character set (SBCS) version of OS/2 is required. The U.S. International keyboard, UX103, supports input of the euro, but a standard English keyboard does not. In all cases, if you do not have a keyboard that supports input of the euro, you are able to display it, but you are not able to input it.

    For information about downloading a particular FixPak, visit the IBM FixPak Web site at:

          http://ps.software.ibm.com/pbin-usa-ps/getobj.pl?/pdocs-usa/otherservices.html


    1.5 Installing the Developer Kit as the Default JVM

    Installing the Developer Kit as the default Java Virtual Machine (JVM) allows you to execute the Developer Kit from a command prompt by default. You can either make the Developer Kit your default JVM permanently or temporarily. See the following sections for more information.

    Permanently Making the Developer Kit your default JVM

    To make the Developer Kit your default JVM permanently, you can either:

    To modify the PATH statement, add x:\JAVA13\JRE\BIN; to the PATH statement in your CONFIG.SYS file.

    If you decide to keep a previous version of Java as the default JVM, do not check the checkbox during the GUI install or, if the Developer Kit is already installed, do not add the x:\JAVA13\JRE\BIN; directory to the PATH statement in your CONFIG.SYS file. If you already have a 1.1.x version of Java installed as the default JVM, it will remain as the default JVM.

    Note:   You may improve performance by removing references to previous releases of Java in the CONFIG.SYS file. However, there are known applications that will fail if you install the Developer Kit (version 1.3) as your default JVM. See the Known Limitations Section section for more information.

    Temporarily Using the Developer Kit for a Java session

    If the Developer Kit is not installed as the default JVM, but you want to use it in a Java session, modify the PATH statement. For example,

    
         SET PATH=x:\JAVA13\JRE\BIN;%PATH%

    x is the drive where you installed the Developer Kit.

    You may improve performance by modifying the BEGINLIBPATH and CLASSPATH statements as follows:

    
         SET BEGINLIBPATH=x:\JAVA13\JRE\BIN;x:\JAVA13\JRE\DLL;%beginlibpath%
    
         SET CLASSPATH= 
    Notice that the CLASSPATH is set to a null value because the Developer Kit's JVM does not generally require the CLASSPATH to find system class files; CLASSPATH is used for application class files.

    Temporarily Using Java 1.1.x for a Java Session

    If the Developer Kit is installed as the default JVM, but you want use a Java 1.1.x JVM in a Java session, modify the PATH statement. For example,

    
        SET PATH=x:\JAVA11\BIN;%PATH%

    x is the drive where you installed the Developer Kit.

    If you removed the JAVA11 references from the CONFIG.SYS file, you need to modify the PATH, BEGINLIBPATH, and CLASSPATH statements as follows:

    
        SET PATH=x:\JAVA11\BIN;%PATH%
    
        SET BEGINLIBPATH=x:\JAVA11\BIN;x:\JAVA11\DLL;%beginlibpath%
    
        SET CLASSPATH=x:\JAVA11\LIB\CLASSES.ZIP;x:\JAVA11\SWING\SWINGALL.JAR;\; 
    Notice that the CLASSPATH is set to the Java 1.1.x library files. The CLASSPATH setting for individual systems will differ.

    To make the Developer Kit and the Java Plug-in execute, you must modify the PATH as shown above.


    1.5.1 JAVA_HOME Environment Variable Information

    If you have installed the Developer Kit (version 1.3) as your default Java Virtual Machine (JVM) and you have:

    You must:


    1.6 Netscape Communicator Information

    The following list contains information about using the Developer Kit and Netscape Communicator v. 4.04 and higher:


    1.7 Joining Split Files

    You can join the split files using the Merge Utility or manually from a command prompt. The following subsections provide information on how to join the split files into one installable file.

    Before you begin, be sure:

    Joining the Split Files Using the Merge Utility:

    Before you begin the process of joining the split files, you must download the Joiner Utility to the same directory as the split files that you downloaded. (The file name is joiner.exe.) The Joiner Utility contains the Merge Utility, which allows you to join the split files into one installable file. The Joiner Utility can be downloaded from the same page as the Developer Kit components on the Software Choice Catalog of Features.

    Type joiner at a command prompt from within the directory where you downloaded the Joiner Utility. This command extracts the Merge Utility (merge.exe) and its required data files. You will use the Merge Utility to join the split files.

    Type the following at a command prompt from within the directory where you downloaded the Joiner Utility:

    
        merge
    
    

    This recreates any packages that are split into multiple files. To install the file, see the Installing the Developer Kit sections

    Joining the Split Files Manually from a Command Prompt:

    1. Ensure that you have downloaded all the split files for the component that you want to install into the same directory.
    2. At a command prompt (from within the directory where you downloaded the split files) type the names of the split files and the complete file name. For example, if you wanted to join the split files for the Runtime Environment, type the following:
         copy /b javainrt.ex1 + javainrt.ex2 + javainrt.ex3 javainrt.exe

    This recreates any packages that are split into multiple files. To install the file, see the Installing the Developer Kit sections


    2.0 INSTALLING THE DEVELOPER KIT

    The following sections give instructions and information about installing the Developer Kit. Before you install the Developer Kit or components associated with it, read the Before You Install section for information on extracting the files and the installation requirements.


    2.1 GUI Installation Method

    Note:  If you have Netscape Communicator running while installing the Developer Kit, the installation will fail. You must shut down Netscape Communicator and then begin the installation process.

    You can install the Developer Kit using either the desktop method or the command prompt method. See the following sections for instructions.


    2.1.1 Desktop Method

    Note:  If you have Netscape Communicator running while installing the Developer Kit, the installation will fail. You must shut down Netscape Communicator and then begin the installation process.

    To install using the INSTALL.EXE object, follow these steps:

    1. Open the OS/2 System folder.
    2. Open the Drives object.
    3. Open the drive where the Developer Kit files were extracted.
    4. Open the folder where the Developer Kit files were extracted.
    5. Double-click the INSTALL.EXE object to start the installation program.

    The INSTALL.EXE command brings up a Graphical User Interface (GUI) with buttons specifying the languages that you can install the program in. Click the language you prefer, and the installation program leads you through the installation steps.

    A Developer Kit for OS/2 folder is created in the Programs folder on OS/2 Warp 4 and on the Desktop in OS/2 Warp Server and OS/2 Warp 3.

    After the installation is complete, if you want to clean up the directory in which the Developer Kit files were extracted, select the DELINST.CMD object from the Developer Kit folder. This removes the Developer Kit files and subdirectories from the directory where they were extracted. Files and subdirectories not extracted from the Developer Kit are not erased. You may also manually delete the files you downloaded.


    2.1.2 Command Prompt Method

    Note:  If you have Netscape Communicator running while installing the Developer Kit, the installation will fail. You must shut down Netscape Communicator and then begin the installation process.

    To start installation, make sure that you are in the directory where the Developer Kit files were extracted. At the OS/2 command prompt, type:

         INSTALL

    The install command brings up a GUI with buttons specifying the languages that you can install the program in. Click the language you prefer, and the installation program leads you through the installation steps.

    A Developer Kit for OS/2 folder is created in the Programs folder on OS/2 Warp 4 and on the Desktop in OS/2 Warp Server for e-business.

    After the installation is complete, if you want to clean up the directory in which the Developer Kit files were extracted, select the DELINST.CMD object from the Developer Kit folder. This removes the Developer Kit files and subdirectories from the directory where they were extracted. Files and subdirectories not extracted from the Developer Kit are not erased. You may also manually delete the files you downloaded.


    2.1.3 Components Not Selectable During Installation

    If you are using the GUI to install the Developer Kit and components are not selectable, you might not have downloaded and extracted the ZIP file containing the component you need. Return to the Software Choice Catalog of Features page and download the self-extracting ZIP file that you need.

    All components of the Developer Kit require that you download and install the Runtime Environment component (or have previously installed the Runtime Environment component) and restarted the system.


    2.1.4 Recovering from a Failed Installation

    If your installation of the Developer Kit fails, check for and delete any remaining installation objects. If you do not delete these installation objects, future installations could fail with a message stating that one or more components could not be installed because the object is read-only or in use by another process.

    For a Configuration, Installation, and Distribution (CID) install, the icon for the installation object is a blue box with a red ribbon and is located on the desktop. For an attended installation, the object is in the x:\os2\install\ folder (where x is the boot drive). To delete the object, click the object using the right mouse button, and click Delete on the menu.

    Alternately, go to the directory containing the object, and delete the entire directory tree. The directory is named either "Install object" or "Java 1.3 for OS!2" depending on when the installation failed.

    After deleting the installation object, shut down and restart the system.

    Cannot Remove the Install Object?

    If, after following the instructions listed above, the install object was not removed, do the following:

    1. Go to an OS/2 command prompt.
    2. Change to the boot drive, and then change to the os2\install directory.
    3. Remove the Java 1.3. for OS!2 directory and all subdirectories.
    4. Restart the system.


    2.1.5 Correct FixPak Level But Cannot Install

    If you are certain that your system meets the required FixPak levels, but are unable to install due to the automated FixPak checking, you may disable the automated FixPak checking. To do this, use either of the following methods:

    Method One:

    1. Edit your CONFIG.SYS file, adding the statement JAVANOFPK=YES.
    2. Restart the system and complete the installation process for the Developer Kit again.

    Method Two:

    1. In the directory where you have ran the self-extracting files, change into the directory for your desired language.
    2. Edit CHECK.CMD file. Look for the statement:
           disablecheck="NO" 
      Change the "NO" to "YES". (This statement is located on or about line 12.)
    3. Change back to the directory where you executed the self-extracting files and execute the files again.


    2.2 Unattended (CID) Installation Method

    Note:  Feature Install version 1.2.3 or later is required for Unattended (CID) installations. Also, if you have Netscape Communicator running while installing the Developer Kit, the installation will fail. You must shut down Netscape Communicator and then begin the installation process.

    Unattended or Configuration, Installation, and Distribution (CID) installations of the Developer Kit are handled by a command-line interface to Feature Install (CLIFI), and can take 15 to 20 minutes or more. After the installation program finishes, the system must be restarted to complete the installation.

    CLIFI requires two response files: the Developer Kit response file (JAVA130.RSP) and a customized response file where users can override the default selections. The CID.RSP file is included in the installation package as an example of the customized response file; this file and CID.CMD file need to be modified for unattended installations.


    2.2.1 Modifying the CID Response File

    Where appropriate, the CID.RSP file contains variables that allow you to select which components to install and the target drive and directory. By default, the CID.RSP file is set to install all the components of Developer Kit. You can modify this response file to select which components you want to install. Be sure to download and extract all of the files you need before you start the installation. Also, if you install the Toolkit, install the Runtime Environment as well, even if the Runtime Environment is already installed.

    The following table lists the selectable components and variable names:

    Component Variable
    Runtime JV13Runtime
    Toolkit JV13Toolkit
    Samples JV13Samples
    OS/2 ICAT Debugger for Java JV13 Debugger
    List of the selectable components and variable names.

    In the CID.RSP file, set "selection=1" for each component you want to install, and set "selection=0" for each component you do not want to install. For example, to:

    but not install the Toolkit component or the Samples component, set the following variables as shown:
    
         Java13.Continue=UNATTENDED
    
         Java13.LicenseAgree=DISAGREE
    
         JV13Runtime.Selection=1
    
         JV13RuntimeConfig.Selection=1
    
         JV13RuntimeUrls.Selection=1
    
         JV13NSFiles.Selection=1
          
         JV13MZFiles.Selection=1
    
         Java13.RUNDRV=x:
    
         JV13DefaultJVM.Selection=1
    
    
    
         JV13Samples.Selection=0
    
         JV13SamplesConfig.Selection=0
    
         JV13Samplesurls.Selection=0
    
         JV13Samples.SMPDRV=x:
    
     
    
         JV13Toolkit.Selection=0
    
         JV13ToolkitConfig.Selection=0
    
    
    
         JV13Debugger.Selection=1     
    
         JV13Debuggerurls.Selection=1
    
         JV13Debugger.DBGDRV=x:
    This is an example. See the CID.RSP file for specific components and their associated variables. x is the drive where the component is installed.

    There is a JV13xxConfig.Selection variable associated with each JV13xx.Selection variable. The JV13xxConfig.Selection variable must be set to the same value as the JV13xx.Selection variable. For example, if you set JV13Toolkit.Selection=0, you must also set JV13ToolkitConfig.Selection=0 (where xx is the component name).

    In the example above, there are several variables that must be set to have the Developer Kit install properly. The variables and their definitions are:

    The JV13.LicenseAgree License Agreement
    Set this variable to AGREE to signify that you have read the license agreement and agree to the terms. If you do not change the variable to the AGREE, the Developer Kit will not install.
    JV13DefaultJVM.Selection JVM
    Set this variable to the value "1" if you want to install the Developer Kit as the default JVM.
    JV13MZFiles Plug-in for IBM Web browser for OS/2
    Set this variable to the value "1" if you want to configure the Plug-in for IBM Web browser for OS/2.
    JV13NSFiles Netscape Plug-in
    Set this variable to the value "1" if you want to configure the Netscape Plug-in.

    To suppress the confirmation windows during installation, set the following variable as shown:

        java13.continue=UNATTENDED

    2.2.1.1 Component Installation Drives

    The Toolkit is installed to the \JAVA13 directory on the target drive. If you install the Toolkit, the Runtime Environment is automatically installed to the same drive as the Toolkit. The Runtime Environment is a prerequisite for the Toolkit, Samples, and Debugger components.

    The target drive for the Samples and ICAT components is specified by setting the drive to the desired values. If the Developer Kit exists on the target drive, the installation program replaces it.


    2.2.2 Starting the Unattended Installation

    The CID.CMD file contains a sample CLIFI command for a CID installation. The installation process has been modified to include a multilingual installation; therefore, you must specify your language variable in the CID.RSP files. The language variables are as follows:

    Language Language Variable
    English en
    French fr
    German de
    Italian it
    Japanese jp
    Portuguese, Brazilian Version   br
    Simplified Chinese cn
    Spanish es
    Traditional Chinese tw
    Language and the language variable associated with it.

    The CLIFI command can also be entered as a single-line command at an OS/2 command prompt, as shown below:

         clifi /a:c /r2:cid.rsp /r:xx\JAVA130.rsp /b:c: /s:d:\tmp\xx
    
         /l1:ciderr.log /l2:cidhist.log

    Use the following variable list as a reference in setting the variables in the files mentioned above.

    Where:
    /r2 represents drive, path, and name for the user response file
    /r Specifies the fully qualified location of the Feature Install response file.
    xx Specifies the preferred language variable.
    /b Specifies the boot drive.
    /s Specifies the fully qualified location of the extracted Developer Kit files.
    /l1 and /l2 Specifies the fully qualified locations of the optional log files. Refer to these files, in addition to the \os2\install\wpinstal.log file on the boot drive, if problems occur during installation.

    To suppress the confirmation windows during installation, set the following variable as shown:

        java13.continue=UNATTENDED

    2.2.3 CID Install "Successful" Return Code / Failed Installation

    If you received a "successful" CID return code after the installation of the Developer Kit, but the installation failed, it might be because:

    It is recommended that CID administrators complete a FixPak check to ensure that the correct FixPak level is available. (See the FixPaks section for more information.) You can use the check.cmd file located in the x:\Java13 directory as an example for writing a script that checks for FixPak levels. (x:\ is the drive where the Developer Kit is installed.)


    2.2.4 Correct FixPak Level But Cannot Install

    If you are certain that your system meets the required FixPak levels, but are unable to install due to the automated FixPak checking, you may disable the automated FixPak checking. To do this, use either of the following methods:

    Method One:

    1. Edit your CONFIG.SYS file, adding the statement JAVANOFPK=YES.
    2. Restart the system and complete the installation process for the Developer Kit again.

    Method Two:

    1. In the directory where you have ran the self-extracting files, change into the directory for your desired language.
    2. Edit CHECK.CMD file. Look for the statement:
           disablecheck="NO" 
      Change the "NO" to "YES". (This statement is located on or about line 12.)
    3. Run the CID process again.


    2.3 NVDM/2 Installation Considerations

    Note:  If you have Netscape Communicator running while installing the Developer Kit, the installation will fail. You must shut down Netscape Communicator and then begin the installation process.

    A NetView(R) Distribution Manager/2 (NVDM/2) CID installation requires creating a profile and then building and cataloging a change file. The NVDM/2 profile allows you to specify only one response file; however, the Developer Kit unattended installation requires two response files. In addition, variable and argument handling in NVDM/2 is different from that used in Feature Install, which is used to install the Developer Kit.

    In the following section are two methods that you can use to install the Developer Kit using NVDM/2.


    2.3.1 Static Command in NVDM/2 Profile

    In the NVDM/2 profile, specify all the CLIFI options in the PARMS variable. The parameters must be on a single line and enclosed in double quotation marks:

    
         Program=c:\os2\install\clifi.exe
    
         Parms="/a:c /r2:cid.rsp /r:\xx\JAVA130.rsp /b:c: /s:d:\tmp\xx
    
         /l1:ciderr.log /l2:cidhist.log"

    This method requires you to modify the profile whenever the source directory or log file names are changed. Alternatively, you could replace these values with workstation-specific variable values, as shown below:

         Program=c:\os2\install\clifi.exe
    
         Parms="/a:c /r2:$(ResponseFile) /r:$(SourceDir)\xx\JAVA130.rsp
    
         /b:c: /s:$(SourceDir\xx) /l1:$(LogFile1) /l2:$(LogFile2)"
    
         ResponseFile=$(WorkstatName).rsp
    
         SourceDir=d:\tmp
    
         LogFile1=$(WorkstatName).log 
    
         LogFile2=$(WorkstatName).lg2

    This second method requires a separate response file for each workstation and requires WorkstatName to be set appropriately.

    Use the following variable list as a reference in setting the variables in the files mentioned above.

    Where:
    d: Specifies the temp directory.
    /r Specifies the fully qualified location of the Feature Install response file.
    xx Specifies the preferred language variable.
    /b Specifies the boot drive.
    /s Specifies the fully qualified location of the extracted Developer Kit files.
    /l1 and /l2 Specifies the fully qualified locations of the optional log files. Refer to these files, in addition to the \os2\install\wpinstal.log file on the boot drive, if problems occur during installation.

    2.4 Installing the Developer Kit on WorkSpace On-Demand 2.0

    Note:  If you have Netscape Communicator running while installing the Developer Kit, the installation will fail. You must shut down Netscape Communicator and then begin the installation process.

    The WorkSpace On-Demand 2.0 product includes Java 1.1.6 for OS/2 Warp. You can install the Developer Kit (version 1.3) on WorkSpace On-Demand servers and clients. The Developer Kit coexists with Java 1.1.x for OS/2 Warp. See the following sections for installing the Developer Kit on WorkSpace On-Demand servers and clients and information on installing the Developer Kit as the default JVM.


    2.4.1 Installing the Developer Kit on a WorkSpace On-Demand 2.0 Server

    To install the Developer Kit on a WorkSpace On-Demand server, use the GUI. See the GUI Installation Method section of this guide for instructions.


    2.4.2 Installing the Developer Kit on a WorkSpace On-Demand 2.0 Client

    To install the Developer Kit on a WorkSpace On-Demand Client, use an unattended (CID) installation. You can use the instructions in the Unattended (CID) Installation Method section and use the CID.CMD and WSOD2.RSP files that are included in the Developer Kit installation package. The steps for installation are completed on a WorkSpace On-Demand 2.0 server.

    Note:  If you want to install the Developer Kit as your default JVM on WorkSpace On-Demand clients, references to the z:\JAVA13 directories and files need to be placed before the z:\JAVA11 references in the CONFIG.SYS file.


    2.4.2.1 Unattended Install for a WorkSpace On-Demand 2.0 Client

    Complete the following steps:

    1. In the CID.CMD file, change /r2:cid.rsp to /r2:wsod2.rsp (where /r2 is the drive, path, and name for the user response file).
    2. As described in Starting the Unattended Installation section of this guide:
    3. Verify that the selections in the WSOD2.RSP files are appropriate for what you want to install. By default the Runtime Environment is selected; all other components are deselected. Be sure to download and extract all of the files you need. Also, after you read the license agreement and agree to the terms, the Java13.LicenseAgree selection variable must be set to AGREE in the WSOD2.RSP file. If you do not change this variable to AGREE, the Runtime Environment will not install.
    4. Run the updated CID.CMD file by typing the file name at a command prompt.

    To complete the unattended install, see the following sections.


    2.4.2.2 Modifying CONFIG.SYS files for WorkSpace On-Demand 2.0 Clients

    To enable the Developer Kit's Runtime Environment component, a WorkSpace On-Demand administrator must make the following additions to the CONFIG.SYS files for the WorkSpace On-Demand clients:

    Add:

    z:\JAVA13\jre\dll to the LIBPATH statement
    z:\JAVA13\jre\bin; to the SET PATH statement

    You can find and edit the CONFIG.SYS file for WorkSpace On-Demand Clients based on the following two options:

    Where:

    [rpldrive] Specifies the drive where the RPL directory is installed.
    [client_name] Specifies the name of the WorkSpace On-Demand client.
    xx Specifies the country code.
    [machine_class] Specifies the name of the machine.
     

    2.4.2.3 Modifying FIT files and Giving Access to WorkSpace On-Demand 2.0 Clients

    To enable the Runtime Environment, a WorkSpace On-Demand administrator must make the following addition to the File Index Table (FIT) files for the WorkSpaces On-Demand clients:

    Add:

         z:\JAVA13      BB20.xx\JAVA13
    You can find and edit the FIT files for WorkSpace On-Demand Clients based on the following two options:

    A WorkSpace On-Demand administrator also must grant read and execute access to the JAVA13 directory for the WorkSpace On-Demand clients:

    Run the following LAN Server commands:

      NET ACCESS [rpldrive]\ibmlan\rpl\bb20.xx\JAVA13 /ADD RPLGROUP:RX
    
      NET ACCESS [rpldrive]\ibmlan\rpl\bb20.xx\JAVA13 /APPLY

    Where:


     
    [rpldrive] Specifies the drive where the RPL directory is installed.
    [client_name] Specifies the name of the WorkSpace On-Demand client.
    xx Specifies the country code.
     

    2.4.2.4 Assigning USER_HOME Directory for WorkSpace On-Demand 2.0 Clients

    The USER_HOME directory for the Developer Kit needs to have read/write access as this is where security certificates and plug-in properties files are created and accessed. For example, to specify z:\JAVA13_RW as the USER_HOME directory and to give it read/write access, add the following to the FIT file (this must be entered as one continuous line):

    
         z:\JAVA13_RW      \\server_name\WRKFILES\client_name\JAVA_RW

    Substitute the names of the WorkSpace On-Demand server and client for server_name and client_name. z is the drive where you installed the Runtime Environment. This could also be entered in the default FIT file.

    A WorkSpace On-Demand administrator must also make the following addition to the OS2.INI files for the WorkSpace On-Demand clients. The addition should be NULL terminated.

    Add:
         Application = Java13
    
         Key = USER_HOME
    
         Value = z:\JAVA13_RW
    
    
    
    
    

    See the WorkSpace On-Demand 2.0 Handbook for information on how to use an INI Editor or the NET APPPARM Command to add INI file entries for WorkSpace On-Demand Clients. You can find the OS2.INI file for WorkSpace On-Demand Clients one of two ways:

    Where:

    z Specifies the drive where the Runtime Environment is installed for the client.
    [rpldrive] Specifies the drive where the RPL directory is installed.
    [client_name] Specifies the name of the WorkSpace On-Demand client.
    xx Specifies the country code.
    [machine class] Specifies the name of the machine class used by a WorkSpace On-Demand client.
     

    2.4.2.5 Enabling Fonts for WorkSpace On-Demand 2.0 Clients

    To enable fonts for the Runtime Environment, a WorkSpace On-Demand administrator must make the following additions to the OS2.INI files for the WorkSpace On-Demand clients. All additions should be NULL terminated. z specifies the drive where the Runtime Environment is installed for the client.

    Add:

      Application = PM_Fonts
    
      Key = courtbi_.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\COURTBI_.TTF
    
    
    
      Application = PM_Fonts
    
      Key = courtb__.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\COURTB__.TTF
    
    
    
      Application = PM_Fonts
    
      Key = courti__.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\COURTI__.TTF
    
    
    
      Application = PM_Fonts 
    
      Key = court___.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\COURT___.TTF
    
    
    
      Application = PM_Fonts
    
      Key = devamt.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\DEVAMT.TTF
    
    
    
      Application = PM_Fonts
    
      Key = devamtb.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\DEVAMTB.TTF
    
    
    
      Application = PM_Fonts
    
      Key = lucb.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\LUCB.TTF
    
    
    
      Application = PM_Fonts
    
      Key = lucbb.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\LUCBB.TTF
    
    
    
      Application = PM_Fonts
    
      Key = lucbbi.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\LUCBBI.TTF
    
    
    
      Application = PM_Fonts 
    
      Key = lucbi.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\LUCBI.TTF
    
    
    
      Application = PM_Fonts
    
      Key = lucs.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\LUCS.TTF
    
    
    
      Application = PM_Fonts
    
      Key = lucsb.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\LUCSB.TTF
    
    
    
      Application = PM_Fonts
    
      Key = lucsbi.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\LUCSBI.TTF
    
    
    
      Application = PM_Fonts
    
      Key = lucsi.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\LUCSI.TTF
    
    
    
      Application = PM_Fonts
    
      Key = luct.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\LUCT.TTF
    
    
    
      Application = PM_Fonts
    
      Key = luctb.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\LUCTB.TTF
    
    
    
      Application = PM_Fonts
    
      Key = luctbi.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\LUCTBI.TTF
    
    
    
      Application = PM_Fonts
    
      Key = lucti.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\LUCTI.TTF
    
    
    
      Application = PM_Fonts
    
      Key = thonbi__.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\THONBI__.TTF
    
    
    
      Application = PM_Fonts
    
      Key = thonburi.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\THONBURI.TTF
    
    
    
      Application = PM_Fonts
    
      Key = thonb___.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\THONB___.TTF
    
    
    
      Application = PM_Fonts
    
      Key = thoni___.ttf
    
      Value = z:\JAVA13\jre\lib\fonts\Thoni___.TTF

    See the WorkSpace On-Demand Handbook 2.0 for information on how to use an INI Editor or the NET APPPARM Command to add INI file entries for WorkSpace On-Demand Clients. You can find the OS2.INI file for WorkSpace On-Demand Clients based on the following two options:

    Where:
    [rpldrive] Specifies the drive where the RPL directory is installed.
    [client_name] Specifies the name of the WorkSpace On-Demand client.
    xx Specifies the country code.
    [machine class] Specifies the name of the machine class used by a WorkSpace On-Demand client.
     

    2.4.2.6 Installing the Netscape Plug-in for WorkSpace On-Demand 2.0 Clients

    To install the Java Plug-in for the Netscape 4.x browser, a WorkSpace On-Demand administrator must copy the npjava.dll file to the WorkSpace On-Demand clients' Netscape 4.x Plug-in directory.

         copy d:\JavaTemp\package\npjava.dll  [rpldrive]:\ibmlan\rpl\bb20.xx\NETSCAPE\PROGRAM\PLUGINS\*.*
    To install the Java Plug-in for the IBM web-browser for OS/2,  copy the npoji6.dll file to the WorkSpace On-Demand clients' Web-browser Plug-in directory.
         copy d:\JavaTemp\package\npoji6.dll  [rpldrive]:\ibmlan\rpl\bb20.xx\os2\os2web\PLUGINS\*.*

    Where:
    d:\JavaTemp Specifies the fully qualified location of the extracted Runtime Environment files.
    [rpldrive] Specifies the drive where the RPL directory is installed.
    xx Specifies the country code.

    In addition, a WorkSpace On-Demand administrator must make the following addition to the OS2.INI files for the WorkSpace On-Demand clients. All additions should be NULL terminated.

    Add:

         Application = Java Plug-in
    
         Key = JAVA_HOME
    
         Value = z:\JAVA13\jre

    Where z specifies the drive where the Runtime Environment is installed for the client.

    See the WorkSpace On-Demand Handbook 2.0 for information on how to use an INI Editor or the NET APPPARM Command to add INI file entries for WorkSpace On-Demand Clients. You can find the OS2.INI file for WorkSpace On-Demand Clients one of two ways:

    Where:
     
    [rpldrive] Specifies the drive where the RPL directory is installed.
    xx Specifies the country code.
    [machine class] Specifies the name of the machine class used by a WorkSpace On-Demand client.
     

    2.4.2.7 Installing Additional Developer Kit Components on the WorkSpace On-Demand 2.0 Client

    If you want to install components other than the Runtime Environment for the WorkSpace On-Demand client, you can select these components in the WSOD2.RSP file.

    If you install the Toolkit, a WorkSpace On-Demand administrator must make the following additions to the CONFIG.SYS files for the clients.

    Add:
    x:\java13\bin; to the SET PATH statement
    z:\JAVA13\lib; to the SET LIB statement
    z:\JAVA13\include; to the SET INCLUDE statement

       where z:\JAVA13 is the drive and directory where the Toolkit is installed for the client.


    2.4.2.8 Running the Java Samples from a WorkSpace On-Demand 2.0 Client

    The WorkSpace On-Demand server administrator must add the following lines to the RPL\FITS\client_name.FIT file to give the WorkSpace On-Demand client the ability to run the samples provided in the Samples component:

         z:\JAVA13\WEBLOGS \\server_name\WRKFILES\client_name\JAVA13\WEBLOGS
    
         z:\JAVA13\HOTJAVA \\server_name\WRKFILES\client_name\JAVA13\HOTJAVA

    Substitute the names of the remote IPL server and the remote IPL client for server_name and client_name. z is the drive where you installed the Developer Kit. This could also be entered in the default FIT file.

    The remote IPL clients can compile the sample code if the samples are placed in a directory to which the remote IPL client has write access.


    2.4.2.9 Issuing a Trust on WorkSpace On-Demand 2.0 Clients

    If you are issuing a trust (giving access) to connect to a Web server, the IDENTITYDB.OBJ file needs to be read/write. Add the following to the FIT file to make the connection:

         z:\JAVA13\WEBLOGS        \\server_name\WRKFILES\client_name\JAVA13\WEBLOGS
    
         z:\JAVA13\HOTJAVA        \\server_name\WRKFILES\client_name\JAVA13\HOTJAVA 
    
         z:\JAVA13\IDENTITYDB.OBJ \\server_name\WRKFILES\client_name\JAVA13\IDENTITYDB.OBJ

    2.4.2.10 The JIT Compiler and a WorkSpace On-Demand 2.0 Client

    On a WorkSpace on Demand client system, the following command is added to the CONFIG.SYS file if version 1.1.6 of the Developer Kit was installed during the WorkSpace On-Demand Server installation:

         set java_compiler=xxx
    This command turns off the just-in-time (JIT) compiler.

    To turn the JIT compiler on, remove the command listed above from your CONFIG.SYS file. You can find and edit the file based on the following two options:

    Use the following variable list as a reference in setting the variables in the files mentioned above:

    Where:
    [rpldrive] Specifies the Request Parameter List.
    xx Specifies the country code.
    [machine class] Specifies the name of the machine class used by a WorkSpace On-Demand client.

    2.4.2.11 Creating a Java Plug-in Control Panel Public Application for the WorkSpace On-Demand 2.0 Client

    To create a public application for the Java Plug-in Control Panel that runs on WorkSpace On-Demand 2.0 client, you need to provide access to the Netscape files. The access controls are specified in the Netscape APPPOST.FIT file.

    The following example shows how to create a public application for running the Java Plug-in Control Panel:

         net app jctrlpnl /remark:"Java Plug-in Control Panel"
    
           /appdir:z:\java13\jre\bin
    
           /command:"jctrlpnl.cmd"
    
           /type:wsod /interface:pm /add
    
    
    
        net appparm jctrlpnl NCC_POSTFITS=z:\netscape\program\apppost.fit
    
           /add /placement:b

          z:\java13 is where the Java Developer Kit image is installed and z:\netscape is where the Netscape image is installed.


    2.5 Installing the Developer Kit on WorkSpace On-Demand 3.0 Client

    Before you begin the installation process, check for or do the following.

    To install the Developer Kit on the client machines, you need to complete the steps in the following Creating an Application Package and Distributing the Developer Kit Application Package to the Client Machines sections.


    2.5.1 Creating an Application Package for the Developer Kit

    To complete the installation process and distribute the Developer Kit to your WorkSpace On-Demand 3.0 clients, you need to create an application package for the Developer Kit on your sandbox client. To do this, complete the following steps:

    1. Download and extract the Developer Kit files into a temporary directory on the WorkSpace On-Demand sandbox OS/2 client.
    2. Access the WorkSpace On-Demand 3.0 application server. For example,
           net use x: \\[AppServ\os2apps]
      Where [AppServ\os2apps] is the name of the application server and the netname for the OS/2 applications.

    3. To create an application package for the Developer Kit on the OS/2 sandbox client, type the following at a command prompt:
          z:\applcptr\crtpkg /start
      Where z is the WorkSpace On-Demand 3.0 client boot drive.

    4. Complete either an attended (requires that Netscape Communicator be installed on the sandbox client) or an unattended installation (does not require that Netscape Communicator be installed on the sandbox client) of the Developer Kit.
    5. Restart the computer.
    6. Access the WorkSpace On-Demand 3.0 application server. For example,
           net use x: \\[AppServ\os2apps]
      Where [AppServ\os2apps] is the name of the application server and the netname for the OS/2 applications.

      Verify that the Developer Kit is functioning correctly by typing:
    7.      x:\JAVA13\jre\bin\java -version
    8. To finish creating the WorkSpace On-Demand 3.0 application package for the Developer Kit, type the following at a command prompt:
           z:\applcptr\crtpkg [JavaApp1] /finish 
      Where [JavaApp1] is the name of the Developer Kit application package.

    For information on DBCS installation considerations, see the Installing the Developer Kit on a DBCS OS/2 WorkSpace On-Demand 3.0 Sandbox Client section.


    2.5.2 Distributing the Developer Kit Application Package to the Client Machines

    Now that you have created a Developer Kit application package on the sandbox client, you are ready to distribute that application package to the other client machines. To do this, complete the following steps:

    1. Use the WorkSpace On-Demand 3.0 Administrator GUI to define a Developer Kit application. (For more information, refer to the on-line help in the WorkSpace On-Demand 3.0 GUI.) The following bullets give information on what to type in the required fields (marked by an asterisk).

    2. The \\AppServ\os2apps\JAVA13\JRE directory (the USER_HOME directory) needs to have read/write access because this is where security certificates and plug-in properties files are created and accessed.

      To create the read/write access, create a FIT file to map to this directory and create APPPOST.FIT in the application's executable directory (where the application's .exe file resides).

      For example, if java.exe is the application's .exe file, then create the APPPOST.FIT file in \\AppServ\os2apps\JAVA13\JRE\BIN. To give read/write access to this directory, add the following lines to the file:

      ;APPFIT ; required for application FITS
      ?:\JAVA13\JRE \\<DCSERVER>\TDMPRFLS\<USER>\OS2\<LANG>\PROFILES\JAVA13\JRE

      The second line needs to be entered as one continuous line.

    3. Assign the Developer Kit application (the [JavaApp1] name used above) to the WorkSpace On-Demand OS/2 client. (See the WorkSpace On-Demand 3.0 Administrator's Guide for more information.)
    4. If you need to define additional Developer Kit applications or applets,

    5. Repeat the previous step for any additional Developer Kit applications or applets.
    6. To create an application package for Netscape (which is capable of running an applet which uses the Java Plug-in), merge the entries from the APPPARM.INI file created for a Developer Kit applet into the APPPARM.INI file created for running Netscape Communicator or the IBM Web browser for OS/2.


    2.6 Remote IPL Installation Method

    A remote IPL installation requires creating two response files and setting up the appropriate directories and files on the remote IPL server.

    Follow these steps for each client to be installed:

    1. Place the extracted Developer Kit installation files on the remote IPL server.
    2. Run the GENFIRPL command. (See the Creating Response Files section for information.)
    3. Run the CLIFI command for one remote IPL client. (See the Starting the Remote IPL Installation section for information.)
    4. Modify the client FIT file (See the sections Updating Files for Feature Install and Running the Java Samples from a Remote IPL Client.)


    2.6.1 Creating Response Files

    After placing the extracted Developer Kit installation files on the remote IPL server, the GENFIRPL command is used to generate two response files: FILES.RSP for the remote IPL server and JAVA130.RSP for the remote IPL client. The following is a sample GENFIRPL command. The command should be entered on a single line.

    
         genfirpl /m:c:\javacode\xx  /r:c:\ibmlan\rpl
    
         /u:c:\ibmlan\rpluser  /f:c:\javacode\xx\JAVA130.rsp
    
         /c:client_name  /b:x:

    The remote IPL client must not be running when the GENFIRPL command is issued. One GENFIRPL command must be done for each remote IPL client, specifying the appropriate client name and boot drive.

    Use the following variable list as a reference in setting the variables in the file(s) mentioned above:

    Where:
    /m Specifies the directory containing the Developer Kit installation files on the remote IPL server.
    xx Specifies the preferred language variable.
    /r Specifies the RPL directory.
    /u Specifies the RPLUSER directory.
    /f Specifies the fully qualified name of the response file for the remote IPL client.
    /c Specifies the name of the remote IPL client.
    /b Specifies the remote IPL client's boot drive.
    /nf Suppresses Java file transfer. Use this flag when installing additional remote IPL clients, after the first one, to prevent the Developer Kit files from being installed again for each new client.

    2.6.2 Modifying the JAVA130.RSP File

    The JAVA130.RSP file contains variables that allow you to select which components to install and the drive and directory. By default, the JAVA130.RSP file is set to install all the components of Developer Kit. You can modify this response file to select which components you want to install. Be sure to download and extract all of the files you need before you start the installation.

    You need to use a text editor that handles lines greater than 255 bytes, such as TEDIT, to prevent truncation of the long lines in this file. Because this file is very large, modifications can be time consuming and error-prone. Make a backup copy of JAVA130.RSP before modifying it to prevent loss of data.


    2.6.3 Updating Files for Feature Install

    The client_name.FIT file for each remote IPL client must be modified to include the following, which must be entered on a single line:

         z:\os2\install\install.inv \\server_name\WRKFILES\client_name
    
         \os2\install\install.inv

    Substitute the name of the remote IPL server and remote IPL client for server_name and client_name. z is the drive where you installed the Developer Kit.


    2.6.4 Starting the Remote Initial IPL Installation

    Remote initial program load (RIPL) installations are handled by CLIFI (the Feature Install installation program) and can take 15 to 20 minutes or more. After logging on to the remote IPL server as an administrator, run the CLIFI command using the response file created for the remote IPL server FILES.RSP:

         clifi /a:i  /r:c:\javacode\files.rsp

    It is necessary to restart the remote IPL Server after running CLIFI if file transfer has not been suppressed.

    Run the CLIFI command on each remote IPL client after you run the GENFIRPL command for that client.

    
         clifi /a:i  /r:z:\xx\JAVA130.rsp

    Use the following variable list as a reference in setting the variables in the files mentioned above.

    Where:
    /r Specifies the fully qualified name of the remote IPL
    client's response file, as specified on the GENFICMD command.
    xx Specifies the preferred language variable.


    2.6.5 Running the Java Samples from a Remote IPL Client

    The remote IPL server administrator must add the following lines to the RPL\FITS\client_name.FIT file to give the remote IPL client the ability to run the samples provided in the Samples component:

    
         z:\JAVA13\WEBLOGS \\server_name\WRKFILES\client_name\JAVA13\WEBLOGS
    
         z:\JAVA13\HOTJAVA \\server_name\WRKFILES\client_name\JAVA13\HOTJAVA

    Substitute the names of the remote IPL server and the remote IPL client for server_name and client_name. z is the drive where you installed the Developer Kit.

    The remote IPL clients can compile the sample code if the samples are placed in a directory to which the remote IPL client has write access.


    2.6.5.1 Issuing a Trust on a Remote IPL Client

    If you are issuing a trust to connect to a Web server, the IDENTITYDB.OBJ file needs to be read/write. Add the following to the FIT file to make the connection:

    
         z:\JAVA13\WEBLOGS \\server_name\WRKFILES\client_name\JAVA13\WEBLOGS
    
         z:\JAVA13\HOTJAVA \\server_name\WRKFILES\client_name\JAVA13\HOTJAVA 
    
         z:\JAVA13\IDENTITYDB.OBJ  \\server\WRKF\client\JAVA13\IDENTITYDB.OBJ 

    Substitute the names of the remote IPL server and the remote IPL client for server_name and client_name. z is the drive where you installed the Developer Kit.

    This can also be entered in the default FIT file as part of the installation of the Developer Kit for WorkSpace On-Demand when running the WSOD.CMD command.


    3.0 AFTER YOU INSTALL

    The following sections provide additional information that you might need after you install the Developer Kit.


    3.1 Additional Sources of Information

    The objects in the following list are displayed in the Developer Kit OS/2 folder only if you are running OS/2 Warp Server 4. If you are running OS/2 Warp Server for e-business, you can access the associated documents at the locations shown.

    x is the drive where you installed the Developer Kit.

    If you installed the Toolkit or ICAT Debugger for OS/2 Java components in different directories from the Runtime Environment component, specify the appropriate directory for these two objects. The links to the Runtime Environment documentation and the ICAT Debugger for OS/2 Java do not work if the components are in different directories or are not installed.


    3.2 Installing Additional Components

    After the initial installation of the Developer Kit, you can install additional components by re-running the installation procedure. This requires that you either download the files from the Software Choice Web site again, keep all of the extracted files on your system, or keep the original ZIP files and extract the files again when needed.


    3.3 AWT TextField and TextArea Considerations

    The AWT TextField and TextArea controls do not support characters outside of the current code page. Users running on U.S. English systems can switch to code page 850 (the multilingual code page, which supports the Western European languages) to see additional language characters in these controls.


    3.4 Modifying Font Properties Files is Not Supported

    Modifying the font properties files provided with the Developer Kit is not supported.


    3.5 Time Problems in Java Applets

    If you have problems with time in your Java applets, you might need to set or change the timezone (TZ) variable. To set the TZ variable, do one of the following:


    3.6 Using the OS/2 High Memory Support to Increase the Java Heap Size

    In a standard OS/2 environment, the maximum virtual address space available to an application is 512 MB, and the memory available for the Java heap size is limited to approximately 256 MB. This restriction can be modified by using OS/2 High Memory Support (OS/2 HMS). OS/2 HMS increases the maximum virtual address space available to an application to three GB.

    The following platforms support OS/2 HMS:


    3.6.1 Enabling OS/2 HMS

    The available High Memory is controlled by the VIRTUALADDRESSLIMIT setting in the CONFIG.SYS file. The value is specified in MBs in the CONFIG.SYS file. For example:

    
            VIRTUALADDRESSLIMIT=2048

    The smallest value allowed is 512 MB. This provides compatibility with previous versions of OS/2 that allowed access to 512 MB. Values in excess of 512 MB can reduce the number of processes that can concurrently run on a system.


    3.6.2 Enabling Java Heap Size To Use OS/2 HMS

    To indicate to the Java Virtual Machine (JVM) that it should attempt to place its heap into OS/2 HMS, set the following environment variable:

        SET JAVA_HIGH_MEMORY=1

    If OS/2 HMS is not available, this option is ignored and the heap is allocated from the standard address space.


    3.6.3 Limitations When Using OS/2 HMS

    If the Java heap is placed in OS/2 HMS, the objects allocated from it are not accessible to 16-bit code. This is only a problem if a Java application has native method DLLs that are either compiled with a 16-bit compiler or call other DLLs that contain 16-bit code.

    OS/2 TCP/IP, prior to version 4.1, has this limitation. OS/2 TCP/IP 4.1 or later must be installed if OS/2 HMS heaps are used.


    3.7 Enhanced BigDecimal Class

    This release includes the BigDecimal class (com.ibm.math.BigDecimal). It is provided (with its supporting class MathContext) as an alternative to the java.math.BigDecimal class. If you are using the java.math.BigDecimal class in a Java program and you want to access the new class, you must change the import statement in your source code as shown below.

    Change:

    
         import java.math.*;
    To:
    
         import com.ibm.math*;
    You do not need to change any other code.


    3.8 The Java Plug-ins

    The following sections give information on installing and using the Java Plug-ins for Netscape 4.x and IBM Web browser for OS/2.


    3.8.1 Installing the Java Plug-in after Installing Netscape Communicator

    If you installed Netscape Communicator after the Developer Kit and want to enable the Java Plug-in, complete the following steps:

    1. Locate the plugin.exe file found in the Runtime Environment's \JAVA13\ns\ directory. Copy the plugin.exe file to a temporary directory.
    2. From within the directory where you copied the plugin.exe file, execute the plugin.exe file by typing the file name at a command prompt. Executing the file extracts the following files:
    3. Return to the \JAVA13\ns\ directory.
    4. Edit the instplug.cmd file to point to the correct paths and boot drive.
    5. Edit the nsuser.rsp file to enable the Java Plug-in. The latest version of Netscape Communicator is enabled. (If you want to enable a specific version of Netscape, set the JAVANSFILES.NSDRV value located in the nsuser.rsp file to the fully qualified drive and directory.)
    6. Execute the instplug.cmd file.
    7. Restart the system.

    Use the following variable list as a reference in setting the variables in the files mentioned above.

    Where:
    xx Specifies the preferred language variable.
    /r Specifies the fully qualified location of the Feature Install response file.
    /r2 Specifies the drive, path, and name for the user response file.
    /b Specifies the boot drive.
    /s Specifies the fully qualified location of the extracted Developer Kit files.
    /l1 and /l2 Specifies the fully qualified locations of the optional log files. Refer to these files, in addition to the \os2\install\wpinstal.log file on the boot drive, if problems occur during installation.

    3.8.2 Installing the Java Plug-in after Installing IBM Web-browser for OS/2

    If you installed the IBM Web-browser for OS/2 after the Developer Kit and want to enable the Java Plug-in for this browser, complete the following steps:

    1. Locate the mzplugin.exe file found in the Runtime Environment's \JAVA13\ns\ directory. Copy the mzplugin.exe file to a temporary directory.
    2. From within the directory where you copied the mzplugin.exe file, execute the mzplugin.exe file by typing the file name at a command prompt. Executing the file extracts the following files:
    3. Return to the \JAVA13\ns\ directory.
    4. Edit the insmzplg.cmd file to point to the correct paths and boot drive.
    5. Edit the mzuser.rsp file to enable the Java Plug-in. The latest version of IBM Web-browser for OS/2 is enabled. (If you want to enable a specific version of the IBM Web-browser for OS/2, set the JAVAMZFILES.NSDRV value located in the mzuser.rsp file to the fully qualified drive and directory.)
    6. Execute the insmzplg.cmd file.
    7. Restart the system.
    Use the following variable list as a reference in setting the variables in the files mentioned above.
    Where:
    xx Specifies the preferred language variable.
    /r Specifies the fully qualified location of the Feature Install response file.
    /r2 Specifies the drive, path, and name for the user response file.
    /b Specifies the boot drive.
    /s Specifies the fully qualified location of the extracted Developer Kit files.
    /l1 and /l2 Specifies the fully qualified locations of the optional log files. Refer to these files, in addition to the \os2\install\wpinstal.log file on the boot drive, if problems occur during installation.

    3.8.3 The Java Plug-in Control Panel

    After the Java Plug-in is installed, you can control the behavior of the Java Plugin at runtime. For example, when you run the Java Plug-in, you can control whether to bring up the Java Console on startup of the Java Plug-in.

    The Control Panel is a Java application launched by the command file located in the [x:\JAVA13]\jre\bin\jctrlpnl.cmd. An icon for this command file is located in the [x:\JAVA13] directory. Where x is the drive where you installed the Developer Kit. By default, JAVA13 is the directory name.


    3.9 Turning Off the JIT Compiler

    A Just-in-Time (JIT) compiler is provided with the Developer Kit. The JIT compiler generates machine code for frequently used byte code sequences in a Java application or applet during execution. The JIT is enabled by default. You can disable the JIT to aid in the isolation of a problem with a Java application, an applet, or the compiler itself by passing the following command to the Java runtime interpreter:

    
    SET JAVA_COMPILER=none

    This command works in both 1.3 and 1.1.x Developer Kit environments.


    3.10 File Name Changes

    There are some short file names based on the 8.3 file name convention required by OS/2 that differ from the long file names required by such platforms as Windows(R) or Linux. Below are the known file names that differ:

    Long File Name OS/2 Short File name
    cmm.dll orb.dll
    fontmanager.dll font.dll
    ioser12.dll iosr12.dll
    java-rmi.exe jrmi.exe
    policytool.exe policy.exe
    keytool.exe keytol.exe
    appletviewer.exe applet.exe
    tnameserv.exe tnames.exe
    rmiregistry.exe rmireg.exe
    .keystore keystore.prp
    Known short and long file names that differ based on the 8.3 file naming convention.


    3.11 Configuring the Applet Viewer

    To set up the applet viewer to connect through a proxy gateway to the Internet:

    1. Click on the Applet Properties.
    2. Click on Properties.
    3. Type your proxy server and port in the corresponding fields

    4. For example:
      
           Http proxy server: myproxy.mycompany.com
      
           Http proxy port:   80

      If your Web browser is already configured to connect to the Internet, use the values set up in that configuration. For example, with WebExplorer, use the Proxy Gateway values in the Configure Servers page, omitting the leading 'http://' and trailing '/'.

      If you do not know your Proxy Gateway, ask your system administrator if you are authorized to use the proxy services.
    5. Click on Apply to store the changes.
    6. Close the applet viewer


    3.12 Specifying Java Options and System Properties

    You can specify Java options and system properties by creating an environment variable called IBM_JAVA_OPTIONS and setting it to the values you require. Any Java options or system properties specified must be preceded by a space, except for the first option. For example, you could set IBM_JAVA_OPTIONS as follows:

    
    IBM_JAVA_OPTIONS=-Dmysysprop1=tcpip -Dmysysprop2=wait
    
    

    If you specify the same options or properties from the command line (or from a JNI program), then these will take precedence over the options and properties specified by the IBM_JAVA_OPTIONS environment variable. The only exception to this rule is when specifying -Xt, -Xtm, or -Xdebug, all of which imply that no JIT should be used.

    Be aware that:

    The system property ibm.jvm.bootclasspath allows an additional search path to be defined. The value of this property is inserted between any value defined by -Xbootclasspath/p: and the bootclass path. The bootclass path is either the default, or that defined using the -Xbootclasspath: option. For further information regarding these options, see 3.1 Additional Sources of Information


    3.13 RMI Over IIOP

    Java Remote Method Invocation (RMI) provides a simple mechanism to do distributed Java programming. RMI over IIOP (RMI-IIOP) extends the base Java RMI to perform communication using the Common Object Request Broker Architecture (CORBA) standard Internet Inter-ORB Protocol (IIOP protocol). This allows direct interaction with any other CORBA Object Request Brokers (ORBs), whether they were implemented in Java or another programming language.

    The Developer Kit includes support for applications developed to use RMI over IIOP (RMI-IIOP). This support is part of the standard Runtime Environment installation and requires no special setup or configuration.


    3.13.1 The IDL-to-Java Compiler

    An IDL-to-Java compiler is included with this release. This tool translates CORBA Interface Definition Language (IDL) to Java. See the IDL-to-Java Compiler User's Guide for further information. This documentation can be found in:

         [x:\JAVA13]\RMI-IIOP\DOCS\toJavaPortableUG.htm

    [x:\JAVA13] is the drive and directory where you installed the Developer Kit. By default, JAVA13 is the name of the directory.

    The IDL-to-Java compiler supports the CORBA 2.3 specification. This includes the "valuetype" construct and its mapping from IDL to Java. Details of this support can be found at the following FTP sites:

    The IDL-to-Java compiler is provided so that you can experiment with the IDL generated by the "rmic -idl" command. This generated IDL and the IDL-to-Java compiler are not required when using RMI-IIOP in the Java to Java case. The generated IDL is used to allow RMI-IIOP to interoperate with other languages such as C++. For interoperation with C++, an IDL-to-C++ compiler that supports the CORBA 2.3 specification must be used to compile the generated IDL.


    3.13.1.1 IDL-to-Java Compiler Restrictions

    The following considerations apply when using the IDL-to-Java compiler:


    3.13.1.2 IDL-to-Java Compiler Known Problems

    The following are known IDL-to-Java compiler problems:


    3.13.2 Additional Information

    For information on IBM and RMI-IIOP, see the following IBM Web site:

         http://www.ibm.com/java/jdk/rmi-iiop/index.html

    Other documentation available:


    3.13.3 RMI-IIOP Terms

    API Application Programming Interface
    CORBA Common Object Request Broker Architecture
    IDL Interface Definition Language
    IIOP Internet Inter-ORB Protocol
    ORB Object Request Broker
    RMI Remote Method Invocation

    3.14 Java Authentication and Authorization Service (JAAS)

    The Java 2 platform provides a means to enforce access controls based on where code came from and who signed it. These access controls are needed because of the distributed nature of the Java platform where, for example, a remote applet can be downloaded over a public network and then run locally.

    However, the Java 2 platform does not provide a way to enforce similar access controls based on who runs the code. To provide this type of access control, the Java 2 security architecture requires and following:

    The Java Authentication and Authorization Service (JAAS) framework provides these enhancements.

    For a general overview of JAAS, see the following Web site:

    From this main page, click Products & APIs and scroll down to the Optional Packages section. The documents at this Web site contain links to many other Web-based information sources.


    3.14.1 Difference Between IBM and Sun Version of JAAS

    The IBM version of JAAS for OS/2 differs from the Sun version of JAAS for Windows in that the com.sun.* packages have been moved to com.ibm.* packages.


    3.14.2 Base Installation

    The following gives information on the location of the JAAS files:

    Note: The Runtime Environment is installed in the x:\JAVA13 directory. (Where x is the drive where you installed the Developer Kit. By default, JAVA13 is the name of the directory.)


    3.15 JNI Programming Information

    Java objects can be accessed from a C program using the Java Native Interface (JNI), which was new with Java 1.1.1. Using the JNI provides a more stable interface than the previous Native Method Interface (NMI).

    JNI applications usually need to interact with the long, float, and double Java types for one or more of the following reasons:

    JNI Native types

    For each of the Java types, the JNI provides native types that you can use in your JNI application. These types are shown in the following table.

    Note:   that there is no need to use these types if your application does not manipulate the Java types long, double, and float.

     
    JNI Native Types
    Java Type JNI Native Type Size in Bytes
    long jlong 8
    double jdouble 8
    float jfloat 4
    JNI Native Types

    Use the JNI native types when defining a native method implementation so that the compiler will match the native method signature with that in the header file generated by using the javah utility.

    Helper Functions and Macros

    The JNI native types jlong, jdouble, and jfloat are incompatible with the respective C/C++ types long, double, and float. If you attempt to cast one to the other, you will get either a compile error or unexpected behavior at runtime. Do not attempt to convert one to the other as the formats of the JNI native types are private to the Developer Kit.

    The JNI header file (jni.h) includes another header file that is shipped with the Developer Kit named int64_md.h. This file defines helper functions and macros that you can use to work with the native types.

    The functions and macros in int64_md.h (relating to jlong) typically include ll either at the start or the end of the name. The functions relating to jdouble or jfloat typically include dbl, double, flt, or float in the name. There are also some jlong, jdouble, and jfloat constants defined.

    The following are macro examples:


    4.0 ADDITIONAL FONT PACKAGE(S)

    If you downloaded one or more of the font packages as one file, skip to the Installing Additional Fonts sections for installation instructions. If you downloaded split files, follow these steps to join the split files into one, installable file. Then, continue to the installation sections.

    1. Ensure that all the split files for the desired font are in the same directory.
    2. At a command prompt and from within the directory that you downloaded the split files into, use the copy command to join the files. You must include the split file names and the file name for the complete font. For example, if you downloaded three split files, type the following:

         Copy /b ExamFont.txx + ExamFont.txx + ExamFont.txx ExamFont.ttf
    Where:
    ExamFont.txx is the name of the split file that you downloaded.
    (xx is the number of the split file that you downloaded.)
    ExamFont.ttf is the complete name of the font.

    4.1 Installing Additional Fonts

    See the following sections for installation information using the CID installation method or the OS/2 Font Palette method.


    4.1.1 CID Installation Method

    To install an additional font using a CID installation, follow these steps:
    1. Locate the wtfont.exe file located in the x:\JAVA13\fonti directory of the Developer Kit. x is the drive where you installed the Developer Kit.
    2. Execute the wtfont.exe file by typing the file name at a command prompt. Executing the file extracts the following files:

    3. Copy the PACKAGE.CTL file into the directory where you downloaded the additional fonts packages.
    4. Edit the wtfnt.cmd file to point to the correct paths and boot drive. See below for a list of parameters.
    5. Edit the wtfntusr.rsp file to select which fonts you want to install.
    6. Execute the wtfnt.cmd file
    7. Restart the system.

    Note:   If CLIFI requests you to "insert the media", then you need to either set the /s: parameter correctly in the wtfnt.cmd file or place the PACKAGE.CTL file in the same directory as the font packages that you want to install.

    Use the following variable list as a reference in setting the variables in the files mentioned above.

    Where:
    /s: Specifies the source of the font packages and the PACKAGE.CTL file.
    /b: Specifies the boot drive.
    /r2: Specifies the drive, path, and name for the user response file.
    /r: Specifies the Feature Install file (wtfntusr.rsp).
    /l1 and /l2 Specifies the fully qualified locations of the optional log files. Refer to these files, in addition to the \os2\install\wpinstal.log file on the boot drive, if problems occur during installation.

    4.1.2 Font Palette Method

    To install an additional font using the Font Palette, follow these steps:

    1. Open the OS/2 System folder.
    2. Click on System Setup Folder.
    3. Click on Font Palette.
    4. Click on the Edit Font button.
    5. Click on the Add button.
    6. Enter the drive and directory where you downloaded the font files.
    7. Select the font you want to install and click Add.


    5.0 DOUBLE-BYTE CHARACTER SET INFORMATION

    The following sections describe known double-byte character set (DBCS) considerations.


    5.1 Installation Panel Text Missing or Too Long in DBCS Countries

    When installing the Developer Kit on DBCS versions of OS/2, DBCS characters might not be displayed on the installation panels or the lines could exceed the right border of the display window, even when the window is maximized.

    To correct these problems, exit the installation program, open the Netscape Navigator or Netscape Communicator for OS/2 object, and select the Options menu item. Open the General Preferences notebook and select the Fonts tab. Choose the proper encoding for your country and then set the proportional and fixed fonts to MINCHO. Click OK to save the changes. When you start the installation of the Developer Kit again, the text should be displayed correctly.


    5.2 TrueType Fonts Must Be Installed on Chinese Systems

    On Simplified or Traditional Chinese systems, ensure that all available OS/2 TrueType fonts are installed. To install these fonts, do the following:

    1. At an OS/2 command prompt and where C: is the boot drive, start the Selective Install program by typing:
           C:\OS2\INSTALL\INSTALL
      A panel titled "System Configuration" is displayed.
    2. Continue to the OS/2 Setup and Installation panel by clicking the Next button (for OS/2 Warp 4.0) or the OK button (for OS/2 Warp Server for e-business).
    3. On the OS/2 Setup and Installation panel, select the TrueType Fonts check box.
    4. Click the More button to the right of this check box.
    5. Make sure all font check boxes are selected. Click OK.
    6. Insert the operating system CD-ROM (OS/2 Warp Server 4.0 or OS/2 Warp Server for e-business) into the CD drive.
    7. Click OK on the Source Directory panel.

    The appropriate fonts should be installed. Restart your system when the font installation is completed.


    5.3 Program Temporary Fixes and FixPaks for DBCS Systems

    Some DBCS users may encounter the following behaviors relating to Asian Input Method operation. To download the Program Temporary Fixes (PTFs) or FixPak listed below, contact your local IBM Service Representative.

    The following table describes behaviors relating to Asian Input Method operation and the DBCS system affected.

    Description DBCS System Affected
    When focus is moved to other frame, Trap occurs in IME. Taiwan
    When focus is moved to other frame at displaying lookup window, conversion operation does not work correctly. Taiwan
    When focus is moved to other frame at displaying lookup window, lookup window does not disappear. Japan
    The correct input mode is not displayed at input mode indicator. Japan, China, Taiwan
    A conversion string at active client does not disappear by pressing ESC key. Taiwan
    When user switches to JAVA native IME, a conversion key does not work correctly. Japan, China, Taiwan
    Descriptions of behaviors relating to Asian Input Method operation and the DBCS system affected.

    Based on the descriptions listed above, the following table shows the PTF level needed if you are using OS/2 Warp 4.

    OS/2 Warp 4 Version PTF
    OS/2 Warp 4 Japanese JR14774
    OS/2 Warp 4 Simplified Chinese (China) CN200006, CN200007
    OS/2 Warp 4 Traditional Chinese (Taiwan) TW200012, TW200013, TW200014, TW200015, TW200016, TW200017
    PTF level needed for OS/2 Warp 4.

    Based on the descriptions listed above, the following table shows the FixPak level needed if you are using OS/2 Warp Server for e-business.

    OS/2 Warp Server for e-business FixPak
    OS/2 Warp 4 Japanese XRJE002
    OS/2 Warp 4 Simplified Chinese (China) XRME002
    OS/2 Warp 4 Traditional Chinese (Taiwan) XRTE002
    FixPak level needed for OS/2 Warp Server for e-business.


    5.4 Controlling Arabic Number Character Display

    Users in some countries could unexpectedly see Arabic number characters appear. Some country-specific versions of OS/2 map the characters x'00B0' through x'00B9' to the Arabic numbers zero (0) through nine (9). To see the desired characters, change the Bi-directional Attributes in CONFIG.SYS or use the Language page in the Properties notebook (Settings notebook in OS/2 Warp Server for e-business) of the object to obtain the desired effect.


    5.5 Japanese Environment Settings on OS/2 Warp 4 Japanese Version

    Use the following Japanese environment settings for OS/2 Warp 4 Japanese version:

    Codepage: 932
    ShiftJIS code: New JIS

    5.6 Required Fonts on OS/2 Warp Japanese Version

    To run the Developer Kit, the following fonts are required on your system:

    Name Style
    GOTHIC Normal
    GOTHIC HeiseiKakuGothic-W5-H-90-TT
    MINCHO HeiseiMincho-W3-H-90-TT
    Required fonts on OS/2 Warp Japanese version.

    You can check them in the Font Palette, which is in the System Setup folder in the OS/2 System folder.

    These fonts can be installed through the Selective Install program object, which is in the Install/Remove folder in the System Setup folder on OS/2 Warp 4 systems and OS/2 Warp Servers for e-business.


    5.7 Improving Font Quality on OS/2 Warp Server for e-business

    On OS/2 Warp Server for e-business, you can improve the font quality of a small point size font by enabling an association between an outline font and a bitmap font. To enable the association, do the following:

    1. Open the OS/2 System folder.
    2. Open the System Setup folder.
    3. Open the System object.
    4. Open the Associate to Bitmap Font page.
    5. Check the Enable button.
    6. Double-click the system menu icon to close the System object.

    If you would like more information on bitmap font association, click the help button located on the Associate to Bitmap Font page.


    5.8 Installing the Developer Kit on a DBCS OS/2 WorkSpace On-Demand 3.0 Sandbox Client

    If you have an Windows NT system application server, the following error may occur if you are running the WorkSpace On-Demand 3.0 CRTPKG utility while creating an application package for the Developer Kit on a DBCS OS/2 WorkSpace On-Demand 3.0 Sandbox Client:

         CRT0071: Can't search directory "z:\OS2\install"  - DosFindFirst/DosFindNext returned error 161. 
    
         CRT0005: Fail to create system snapshot.

    This error is a result of the name of the last directory or file in the z:\OS2\install directory containing a '5C' byte. The installation of the Developer Kit creates a directory in z:\OS2\install. This name, when translated into English, means "Installed Features". Delete or rename this directory and then run the CRTPKG utility. You should be able to correctly create an application package for the Developer Kit.


    6.0 UNINSTALLING THE DEVELOPER KIT

    The following sections give you information on uninstalling the Developer Kit.

    If you have installed components of the Developer Kit multiple times without uninstalling those components, references to JAVA13 continue to exist in your CONFIG.SYS file. If you want those references to be removed, delete them from your CONFIG.SYS file.

    Note:  If you have Netscape Communicator running while uninstalling the Developer Kit, the uninstall will fail. You must shut down Netscape Communicator and then begin the uninstall process.


    6.1 Desktop Method

    To uninstall using the Remove the Developer Kit object, follow these steps:

    1. Open the OS/2 System folder.
    2. Open the System Setup folder.
    3. Open the Uninstall Features folder. If you are uninstalling from OS/2 Warp 4, open the Install/Remove folder and then the Uninstall Features folder.
    4. Double-click the Remove the Developer Kit for OS/2 object to start the uninstall program.

    If you extracted any additional fonts files or Java Plug-in files like the plugin.exe or mzplugin.exe, and you want to remove them from your system, go to the drive and directory where you installed them and delete them.


    6.2 OS/2 Command Prompt Method

    To start uninstalling, make sure that you are at the root drive where the Runtime Environment is installed. At an OS/2 command prompt, enter:

         JAVA13/UNINSTAL/UNINSTAL

    The uninstall program leads you through the uninstallation process. Only files and directories created by the installation process are removed. For instance, the HOTJAVA directory created by running the Applet Viewer is not removed during uninstallation.

    If you extracted any additional fonts files or Java Plug-in files like the plugin.exe or mzplugin.exe, and you want to remove them from your system, go to the drive and directory where you installed them and delete them.


    6.3 Uninstalling the Developer Kit from WorkSpace On-Demand 2.0

    Support for uninstalling the Developer Kit requires access to an inventory object (Java 1.3) in the Installed Features directory (\os2\install\installed features). If you install the Developer Kit for both the WorkSpace On-Demand 2.0 client and the WorkSpace On-Demand 2.0 server, the Java 1.3 inventory object is damaged or replaced. Therefore, do not use the uninstall program to remove the Developer Kit components from the client space.

    Instead, delete the [rpldrive]\ibmlan\rpl\bb20.xx\JAVA13 directory structure and any references made to this directory that were added to the WorkSpace On-Demand client image directories. (Such as the CONFIG.SYS, OS2.INI, and FIT files.)

    To remove the Developer Kit from the server, delete the \JAVA13 directory structure. You can delete the directory structure from the Drives folder in the OS/2 System folder.


    6.4 Performing an Unattended Uninstallation

    To uninstall the Developer Kit, enter the following single-line command at an OS/2 command prompt:

         clifi /a:u /f:"<WP_INSTALLED>" /o:INV_JAVA13 /set:Selection=ALL

    6.5 Removing the Developer Kit as the Default JVM

    To remove or replace the Developer Kit as your default JVM, remove the x:\JAVA13\JRE\BIN; statement from your PATH statement in your CONFIG.SYS file. For the change to take effect, restart the system.


    7.0 KNOWN LIMITATIONS


    8.0 NOTICES

    (c) Copyright International Business Machines Corporation 1999, 2001. All rights reserved.

    (c) Copyright Sun Microsystems, Inc. 1997, 2001. 901 San Antonio Rd., Palo Alto, CA 94303 USA. All rights reserved.

    U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

    Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

    IBM may have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:

          IBM Director of Licensing
          IBM Corporation
          North Castle Drive
          Armonk, NY 10504-1758
          U.S.A.

    For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

          IBM World Trade Asia Corporation Licensing
          2-31 Roppongi 3-chome, Minato-ku
          Tokyo 106-0032, Japan

    The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:

    INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

    Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

    This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the information. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this information at any time without notice.

    Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

    IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

    Licensees of this program who wish to have information about it for the purpose of enabling (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

          JTCMAIL@uk.ibm.com
          [Hursley Java Technology Center (JTC) contact]

    Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

    The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

    Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

    Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

    All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

    All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice. Dealer prices may vary.

    COPYRIGHT LICENSE:

    This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written.

    These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces.

    This edition applies to version 1.3 of the IBM OS/2 Warp Developer Kit, Java(TM) Technology Edition and to all subsequent releases and modifications until otherwise indicated in new editions.

    This software is based in part on the work of the Free Type Project. For more information about the Free Type Project, see: http://www.freetype.org


    9.0 TRADEMARKS

    The following terms are trademarks of International Business Machines Corporation in the U.S., or other countries, or both:

          IBM
          OS/2
          OS/2 Warp
          NetView

    Java is a trademark of Sun Microsystems, Inc. in the U.S. and other countries. The Java technology is owned and exclusively licensed by Sun Microsystems, Inc.

    Netscape and Netscape Navigator are trademarks of Netscape Communications Corporation.

    Intel and Pentium are registered trademarks of Intel Corporation in the United States and other countries.

    Tivoli is a registered trademark of International Business Machines Corporation or Tivoli Systems Inc. in the United States, other countries, or both.

    Other company, product, and service names may be trademarks or service marks of others.


    [END-OF-INSTALLATION AND CONFIGURATION GUIDE]